home *** CD-ROM | disk | FTP | other *** search
Wrap
XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt - A toolkit function that converts selections to standard targets SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/TransferP.h> vvvvooooiiiidddd XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt( WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt, XXXXttttPPPPooooiiiinnnntttteeeerrrr iiiiggggnnnnoooorrrreeee, XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt ****ccccaaaallllllll____ddddaaaattttaaaa); VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents Motif 2.1. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt converts a selection to one of a set of standard targets. This function can be called only from an XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkprocedure or from a ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method. The target to which this routine tries to convert the selection is the _t_a_r_g_e_t member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed in the _c_a_l_l__d_a_t_a argument. If XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt converts the selection to that target, it fills in the _v_a_l_u_e, _t_y_p_e, _f_o_r_m_a_t, and _l_e_n_g_t_hmembers of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. Otherwise, it does not alter the callback struct. Note that XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt does not alter the _s_t_a_t_u_smember of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The routine that calls XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt is responsible for looking at the _v_a_l_u_e parameter and determining whether or not the conversion succeeded. If the _v_a_l_u_e parameter contains _N_U_L_L, then the conversion did not succeed. Following are the targets to which XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt converts selections: _B_A_C_K_G_R_O_U_N_D The routine sets the _v_a_l_u_e member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttto the value of widget _w_i_d_g_e_t's XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd resource. The routine sets the _f_o_r_m_a_t member to 32, the _l_e_n_g_t_h member to 1, and the _t_y_p_e member to _P_I_X_E_L. _C_L_A_S_S The routine finds the first shell in the widget _w_i_d_g_e_t's hierarchy that has a WWWWMMMM____CCCCLLLLAAAASSSSSSSS property. The properties of this shell determine the _v_a_l_u_e, _f_o_r_m_a_t, _l_e_n_g_t_h, and _t_y_p_e members of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. _C_L_I_E_N_T__W_I_N_D_O_W Page 1 (printed 4/6/01) XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt((((3333XXXX)))) The routine finds the first shell in the widget _w_i_d_g_e_t's hierarchy. The routine sets the _v_a_l_u_e member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt to the widget ID of this shell. This routine sets the _f_o_r_m_a_t member to 32, the _l_e_n_g_t_h member to 1, and the VVVVyyyyppppeeee member to _W_I_N_D_O_W. _C_O_L_O_R_M_A_P The routine sets the _v_a_l_u_e member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttto the value of widget _w_i_d_g_e_t's XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp resource (or to the value of the XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp resource of widget _w_i_d_g_e_t's parent, if _w_i_d_g_e_t is a gadget). This routine sets the _f_o_r_m_a_t member to 32, the _l_e_n_g_t_h member to 1, and the _t_y_p_e member to _C_O_L_O_R_M_A_P. _F_O_R_E_G_R_O_U_N_D The routine sets the _v_a_l_u_e member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttto the value of widget _w_i_d_g_e_t's XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd resource. The routine sets the _f_o_r_m_a_t member to 32, the _l_e_n_g_t_h member to 1, and the _t_y_p_e member to _P_I_X_E_L. _N_A_M_E The routine finds the first shell in widget _w_i_d_g_e_t's hierarchy that has a WWWWMMMM____NNNNAAAAMMMMEEEE property. The properties of this shell determine the _V_v_a_l_u_e. This routine sets the _f_o_r_m_a_t member to 8, the _l_e_n_g_t_h member to the number of characters in _v_a_l_u_e, and the _t_y_p_e member to the current locale. _T_A_R_G_E_T_S The routine sets the _v_a_l_u_e member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttto the list of targets returned by XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss. This routine sets the _f_o_r_m_a_t member to 32, the _l_e_n_g_t_h member to the number of targets in the list, and the _t_y_p_e member to _A_T_O_M. ____MMMMOOOOTTTTIIIIFFFF____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE The routine sets the _v_a_l_u_e member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttto the value of the widget _w_i_d_g_e_t's XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeresource if it exists, or else the default text render table. More precisely, the _v_a_l_u_e member will hold a string of characters representing the render table. This routine sets the _f_o_r_m_a_t member to 8, the _l_e_n_g_t_h member to the number of characters in the _v_a_l_u_emember, and the _t_y_p_e member to _S_T_R_I_N_G. ____MMMMOOOOTTTTIIIIFFFF____EEEENNNNCCCCOOOODDDDIIIINNNNGGGG____RRRREEEEGGGGIIIISSSSTTTTRRRRYYYY The routine transfers the widget's encoding registry. The routine sets the _v_a_l_u_e member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt to a list of NULL- separated items in the form of tag encoding pairs. Page 2 (printed 4/6/01) XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt((((3333XXXX)))) This target symbolizes the transfer target for the Motif Segment Encoding Registry. Widgets and applications can use this Registry to register text encoding formats for specified render table tags. Applications access this Registry by calling XXXXmmmmRRRReeeeggggiiiisssstttteeeerrrrSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg and XXXXmmmmMMMMaaaappppSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg. This routine sets the _f_o_r_m_a_t member to 8, the _l_e_n_g_t_h member to the number of characters in the _v_a_l_u_emember, and the _t_y_p_e member to _S_T_R_I_N_G. Following are the arguments to this function: _w_i_d_g_e_t Specifies the reference widget for the conversion. _i_g_n_o_r_e This argument is ignored. Its value should always be _N_U_L_L. _c_a_l_l__d_a_t_a Specifies a pointer to the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt to be modified. XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt modifies the following members of the structure only. (For details on XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt, see XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee(3) in the _M_o_t_i_f _P_r_o_g_r_a_m_m_e_r'_s _R_e_f_e_r_e_n_c_e.) _v_a_l_u_e An _X_t_P_o_i_n_t_e_r parameter that contains any data that XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt produces as a result of the conversion. XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt sets _v_a_l_u_eto _N_U_L_L if it cannot convert the target. _t_y_p_e An AAAAttttoooommmm parameter that indicates the type of the data in the _v_a_l_u_e member. _f_o_r_m_a_t An _i_n_t parameter that specifies whether the data in _v_a_l_u_eshould be viewed as a list of 8-bit, 16-bit, or 32-bit quantities. _l_e_n_g_t_h An uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg parameter that specifies the number of elements of data in _v_a_l_u_e, where each element has the number of bits specified by _f_o_r_m_a_t. RRRREEEELLLLAAAATTTTEEEEDDDD XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(3), XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(3), and XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(3). Page 3 (printed 4/6/01)